Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 7 - Finder Interface Reference / Finder Interface Functions

Manipulating Folder Descriptors /

RemoveFolderDescriptor

NEW WITH MAC OS 8

Removes the specified folder descriptor entry from the system folder list.

pascal OSErr RemoveFolderDescriptor (FolderType foldType);

foldType

A constant identifying the type of the folder for which you wish to remove a descriptor. See "Folder Type Constants".

function result

A result code; see "Result Codes".

DISCUSSION

Once a folder descriptor has been removed, FindFolder will no longer be able to locate the folder type.

SPECIAL CONSIDERATIONS

Before calling the RemoveFolderDescriptor function, you must pass the selector gestaltFindFolderAttr to the Gestalt function. If the gestaltFolderDescSupport bit is set, RemoveFolderDescriptor is available.